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Appendix A (connection_setup_proxycode) 

******************************** ************* 

* INSTRUMENTATION METHODS 

* Here are example methods that will be instrumented in to application 

* (in pseudo-code) 

*************************************************************************** / 
/** 

* this is the replacement method for Connector. open(String) 

* Return the original connection bug add the connection 

* to the network connection list if it is network connection 

V 

public static Connection open (St ring name) throws lOException 
Connection conn = Connector. open (name) ; 

if(name.startswith("http://") || name. start swith ("socket ://")) { 
_netWorkConnecti on . addEl ement (conn) ; 

} 

return conn; 

} 

/** 

* this is the replacement method for Connector .open (String, int) 
Cl * Return the original connection bug add the connection 

O * to the network connection list if it is network connection 

*/ 

public static Connection open(String name, int mode) throws lOException 

il Connection conn = connector .open(name, mode); 

fn 

rr if(name.startswith("http://") || name.startsWithC'socket://")) { 

^ _networkConnecti on . addEl ement (conn) ; 

} 

return conn; 

Q1 /- 

pi * this is the replacement method for Connector .open (St ring, int, boolean) 

* Return the original connection bug add the connection 

* to the network connection list if it is network connection 
*/ 

public static Connection open (St ring name, int mode, boolean timeouts) 
throws lOException 

Connection conn = Connector .open(name, mode, timeouts); 

if(name.startswith("http://") || name. startswith ("socket ://")) { 
_netWorkConnecti on . addEl ement (conn) ; 

} 

return conn; 

} 

* this is the replacement method for the Connection.closeO method. 

* This method wi 11 remove any network connection from the list 

* when it is close 
*/ 

public static void close (connection conn) throws lOException 
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Appendix A (connect! on_setup_proxycode) 
_networkConnecti on . removeEl ement (conn) ; 
conn. close () ; 



Page 2 



EXPRESS MAIL NO. EV064992025US 



Appendix B (send^proxycode) 



Note: The pseudo-code in this file are exerpts from the original code file 
that manages receiving and sending of the data. 



/* Send data to the original remote host (as specified by original code) 

* conn " Original connection created for communicating with host 

* dgram — The datagram that's to be sent, 
*/ 

public static void send(DatagramConnection conn, Datagram dgram) 
throws lOException 

conn. send (dgram) ; 

// increase the total of bytes send 
i ncrementSentBytes (dgram . getLength ()) ; 



* Increment the internal counter by number of bytes sent to the 

* remote host. 

V 

public static void i ncrementSentBytes (long bytes) 

synch roni zed (_synch roni zedob j ) { 
_total sentBytes += bytes; 

// we alway save billing info at the first time 
if ((System. currentTimeMillisO - _time) > 60* 1000) { 
phaseOneO ; 

_time = system- cur r entTi meMi n i s() ; 

} 

} 

} 

* This phase will save the heap info to rms 
*/ 

private static void phaseOneO 

try { 

// check the caches 

if((-lastSentBytes « -1) && (^lastReceivedBytes == -1)){ 
loadBillinglnfoO ; 



// save new billing info and update caches 
saveBi Hi nginf o () ; 

// do autosend this code can be taken out depend on device 
if (System. currentTimeMi Hi s() - ^recordStoreTime > 24*60*60*1000) { 
phaseTWoO ; 



catch (Except! on e){} 



* Send billing info from rms to MAS server 

V 
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public static void phaseTwoQ 

try{ 

// check the caches 

ifCCIastSentBytes ==-!)&& ClastReceivedBytes == 
^ loadBininglnfoQ ; 

// get total 

_1 as tSentBytes += .total SentBytes ; 

_1 as tRecei vedByt es += „total Recei vedBytes ; 

// send billing info 
autoSendBillinglnfoQ ; 

// successful 1 sending data so clear the rms 
clearRecordstoreQ ; 

} 

^ catch (Exception e){} 

* This method will load the packet base billing record to the cache and 

* keep the billing info in the record store 

* This method will be used by the phaseOne and phaseTWo 

* 

*/ 

private static void loadBillinginfoQ 
try { 

synchronized (_synchronizedObj) { 
Recordstore recordstore = 

RecordStore.openRecordStoreCRECORD_STORE_NAME, true) ; 

int id = recordstore. getNextRecordlDO - 1; 

byte [] record = recordstore. getRecord(i d) ; 
ByteArraylnputStream bis = new ByteArraylnputStream(record) ; 
Datainputstream dis = new DatainputStream(bis) ; 

// load the billing info 

.las tRecei vedBytes - dis. readLongO ; 

_lastSentBytes = dis.readLong(); 

_recordStoreTime = dis.readLongQ; 

// close intput stream and record store 

// don't need to close ByteArraylnputStream 

recordstore. closeRecordstoreC) ; 

} 

} 

catch (Exception e) { 

// there is not thing in the record store. Give an initialization data 
.lastRecei vedBytes = 0; 
.lastSentBytes = 0; 

.recordStoreTime = System.currentTimeMillisO ; 

} ^ 

* Save new billing info rms + heap then delete the old record and update 

* the caches 
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V 

private static void saveBininginfoQ 

throws RecordStoreNotFoundException, RecordStoreException, 
lOException , RecordStoreFul 1 Exception 

RecordStore recordstore = null; 
byte [] record = null; 
synchronizedCsynchronizedObj) { 
// save the new info 

recordstore = RecordStore. openRecordStore(RECORD_STORE_NAME, true); 

ByteArrayOutputStream bos = new ByteArrayOutputStream(24) ; 
DataOutputStream dos = new DataOutputStream(bos) ; 

// save new received bytes = last received + heap 
dos.writeLong(_lastReceivedBytes + _totalReceivedBytes) ; 

// save new sent bytes = last sent + heap 
dos.writeLongClastSentBytes + _totalSentBytes) ; 

// save time 

dos .wri teLong(_recordStoreTi me) ; 
// save 

record = bos.toByteArrayO ; 

recordstore. addRecordCrecord, 0, record, length) ; 

// already saved new record so update last info 
_lastReceivedBytes += _totalReceivedBytes; 
^lastSentBytes += _totalSentBytes; 



// now clear the heap 
clearHeapO ; 

// already saved new record so delete the old one 
if (recordstore. getNumRecordsQ > 2) { 

recordstore. del eteRecord(recordStore.getNextRecordiD() - 2); 



// close output stream and record store 

// don't need to close ByteArrayOutputStream 

recordstore. closeRecordStoreQ ; 

} ^ 



* Send the packet base billing info to MAS. After successful sending 

* billing record, clear all the record (heap and record store) 

* This method is used by the sendBillinglnfo and saveBillinglnfo 
*/ 

private static boolean autoSendBillinglnfoO throws lOException 

if (-.lastReceivedBytes <=0 && _1 astsentsytes <=0) { 
return true; 

} 

String es = "&"; 
String eq = "="; 
if(ESCAPE_URL 1= 0) { 
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es = "%26"; 
eq = "%3D"; 



StringBuffer buff = new StringBufferQ ; 
// append url 

buff . append (MAS„PACKET_BASE_BILLING_URL) ; 
buff .append (es) ; 

// append total bytes sent 
buff .append("sent + eq); 
buff .append ClastSentBytes) ; 
buff -append (es); 

// append total bytes received 
buff .append ("received" + eq); 
buff .append CI as tReceivedBytes) ; 

string request = buff .toSt ring () ; 

System . out . pri ntl n (request) ; 

// try to send billing info for 3 times, 
int numOf Retry = 0; 
while(numOfRetry < 3) { 
try { 

HttpConnection conn = (HttpConnection) Connector .open (request) ; 
inputstream is = conn.openinputStreamO ; 

// close intput and connection 
is.closeO ; 
conn.closeQ; 
return true; 

} 

catch(Exception e) { 
numOfRetry++; 

} * 

// we don't need to check for response if the http connection fail, it 
// will through exception 
return false; 



private static void clearRecordStoreO 

synchronized(_synchronizedObj) { 
try{ 

_lastReceivedBytes = 0; 

_lastSentBytes = 0; 

Recordstore recordstore = 

RecordStore.openRecordstore(RECORD_STORE_NAME, false) ; 
recordstore. del eteRecord (recordstore. getNextRecordlDO - 1); 
recordstore. closeRecordStoreO ; 

// reset the record store time 
_recordStoreTime = System. cur rentTimeMi Hi s () ; 

catch (Exception e){} 



// The local variables used in the above section of code 
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public static long _totalSentBytes = 0; 

public static long _lastSentBytes = -1; 

public static long _totalReceivedBytes = 0; 

public static long _lastReceivedBytes = -1 

public static Object ^synchronizedobj = new ObjectQ; 

public static long _time = 0; 

public static long _recordStoreTim€ = 0; 

public static vector _networkConnection = new vector(3); 

/////////////////////////////////////////////////////////////////////////// 
/////// Public constructor 

public BillingOutputStreamCOutputStream out) 

^ _outputStream = out; 

/////////////////////////////////////////////////////////////////////////// 
mini Public Members (Access Methods) 

public void write (int b) throws lOException 

_outputStream.wri te(b) ; 
_total SentBytes++ ; 
increment () ; 

} 

public void write(byte [] b) throws lOException 

_outputStream.wri te(b) ; 
_totalSentBytes += b. length; 
incrementO ; 

} 

public void write (byte [] b, int off, int Ten) throws lOException 

_outputStream.write(b, off, len); 
_totalSentBytes += len; 
incrementO; 

} 

public void flushO throws lOException 
^ _outputStream.flush() ; 

public void close () throws lOException 

// save the total sent bytes 
if (-total sent Bytes > 0) { 
PacketBaseBi 11 i ng . i ncrementSentBytes (_total SentBytes) ; 

// reset the total sent bytes in case close() is called again 
_total SentBytes = 0; 
^ _outputStream,close() ; 

private void incrementO 

if(_total SentBytes > packet) { 

PacketBaseBi 11 i ng . i ncrementSentBytes (_total SentBytes) ; 

Page 5 



Appendix B (send_proxycode) 

_total SentBytes = 0; 

} ^ 

/////////////////////////////////////////////////////////////////////////// 
/////// Private Fields 

private OutputStream _outputStream; 
private long _totalSentBytes = 0; 

private final static int PACKET = 10; 
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Appendix C Creceive_proxycode) .txt 

Note: The pseudo-code in this file are exerpts from the original code file 
that manages receiving and sending of the data. 

* This proxy code allows original connection to get data and then 

* increments the internal counter to record it. 

* conn Original connection created for communicating with host 

* dgram The datagram that's to be sent. 

*/ 

public static void receiveCoatagramConnection conn, Datagram dgram) 
throws lOException 

conn. receive (dgram) ; 
^ incrementReceivedBytes(dgram.getLengthC)) ; 

public static void incrementReceivedBytes(long bytes) 

synch roni zed Csynch roni zedob j ) { 
_totalReceivedBytes += bytes; 

0 // we alway save billing info at the first time 

CI ifCCsystem.currentTimeMillisQ - _time) > 60*1000) { 

// save billing info 
1% phaseoneO; , ...... 

^ _time = system. currentTi meMil 1 1 sO ; 



m } 
C } 



* This phase will save the heap info to rms 

V 

private static void phaseoneQ 

try { 

// check the caches 

ifCC-lastsentsytes == -1) && ClastReceivedsytes == -1)){ 
^ loadBillinginfoO ; 

// save new billing info and update caches 
saveBi Hi nginf oQ ; 

// do autosend this code can be taken out depend on device 

if (system. cur rentTimeMillisQ - .recordStoreTime > 24*60*60*1000) { 

^ phaseTwoO; 

^ catch (Except ion e){} 

* Send billing info from rms to mas server 

*/ 

public static void phaseTwoO 
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try{ 

// check the caches 

ifCCIastsentBytes == -1) && C-lastReceivedBytes == 
^ loadBillinginfoQ ; 

// get total 

_lastSentBytes += _totalsentBytes; 

..lastReceivedBytes += _totalReceivedBytes; 

// send billing info 
autoSendBi Hi nginf o() ; 

// successful! sending data so clear the rms 
clearRecordstoreQ ; 

catch (Exception e){} 



* This method will load the packet base billing record to the cache and 

* keep the billing info in the record store 

* This method will be used by the phaseone and phaseTwo 
* 

*/ 

private static void loadBillinglnfoC) 
try { 

synchronized Csynchronizedobj) { 
RecordStore recordstore = 

Recordstore . openRecordstore(RECORD_STORE_NAME , true) ; 

int id = recordstore. getNextRecordiDQ - 1; 

byte [] record = recordstore, getRecordCi d) ; 
ByteArraylnputStream bis = new ByteArrayinputstream(record) ; 
Datalnputstream dis = new Datalnputstream(bis) ; 

// load the billing info 

_lastReceivedBytes = dis. readLongC) ; 

_lastSentBytes = dis. readLongC) ; 

_recordStoreTime = dis.readLongO ; 

// close intput stream and record store 

// don't need to close ByteArraylnputStream 

recordStore.closeRecordStoreC) ; 

} 

} 

catch (Exception e) { 

// there is not thing in the record store. Give an initialization data 
_lastReceivedBytes = 0; 
_lastSentBytes = 0; 

_recordstoreTime = system. currentTimeMi 11 i sC) ; 

} ^ 

* save new billing info rms + heap then delete the old record and update 

* the caches 

V 
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private static void saveBillinglnfoQ 

throws RecordStoreNotFoundException, RecordstoreException, 
lOExcepti on , RecordstoreFul 1 Excepti on 

RecordStore recordstore = null; 
byte [] record = null; 
synchroni zed C_synchroni zedob j) { 
// save the new info 

recordstore = Recordstore. openRecordstore(RECORD_STORE_NAME, true); 

ByteArrayOutputStream bos = new ByteArrayOutputstream(24) ; 
DataOutputStream dos = new DataoutputSt ream (bos) ; 

// save new received bytes = last received + heap 
dos.writeLongClastReceivedBytes + _totalReceivedBytes) ; 

// save new sent bytes = last sent + heap 
dos.writeLongClastSentBytes + _total SentBytes) ; 

// save time 

dos . wri teLong (_r eco rdStoreTi me) ; 

// save 

record = bos.toByteArrayQ ; 

recordstore. addRecordC record, 0, record. length) ; 

// already saved new record so update last info 
_lastReceivedBytes += _totalReceivedBytes; 
^lastSentBytes += _totalSentBytes; 



// now clear the heap 
clearHeapO ; 

// already saved new record so delete the old one 
if (recordstore. getNumRecordsQ > 2) { 

recordstore. del eteRecord(recordStore.getNextRecordlD() - 2); 



// close output stream and record store 

// don't need to close ByteArrayOutputStream 

recordstore. closeRecordStoreO ; 



* send the packet base billing info to MAS. After successful sending 

* billing record, clear all the record (heap and record store) 

* This method is used by the sendBillinglnfo and saveBi 1 1 i nginf o 

V 

private static boolean autoSendBillinginfoO throws lOException 

if(-.lastReceivedBytes <=0 && ^lastsentBytes <=:0) { 
return true; 

} 

string es = "&"; 
String eq = "="; 
if(ESCAPE„URL 1= 0) { 

es = "%26"; 

eq = "%3D"; 
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StringBuffer buff = new StringBufferO ; 
// append url 

buff . append Cmas_packet_base_billing JRL) ; 
buff -append (es); 

// append total bytes sent 
buff .appendC'sent" + eq); 
buff -append CI as tsent Bytes) ; 
buff .append (es) ; 

// append total bytes received 
buff .appendC"received" + eq); 
buff . append (Jl astRecei vedBytes) ; 

string request = buff .tost ring Q ; 
system. out .println(request) ; 

// try to send billing info for 3 times, 
int numof Retry = 0; 
whileCnumof Retry < 3) { 
try { 

Httpconnection conn = (HttpConnection) Connector. open (request) ; 
inputstream is = conn.openinputStreamO ; 

// close intput and connection 
is. close () ; 
conn.closeQ ; 
return true; 

catch (Exception e) { 
numofRetry++; 

} ^ 

// we don't need to check for response if the http connection fail, it 
// will through exception 
return false; 

} 

private static void clearRecordstoreO 

syn ch roni zed (_synch roni zedob j ) { 
try{ 

„1 astRecei vedBytes = 0; 
_lastSentBytes = 0; 

Recordstore recordstore = 

Recordstore .openRecordstore(RECORD_STORE_NAME , f al se) ; 
recordstore. del eteRecord (recordstore. getNextRecordlDO - 1); 
recordstore- closeRecordStoreO ; 

// reset the record store time 
_recordStoreTime = system. currentTimeMi Hi s() ; 

^ catch (Except! on e){} 



// The local variables used in the above section of code 
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public static long _total SentBytes = 0; 

public static long _last Sent Bytes = -1; 

public static long ^totalReceivedBytes = 0; 

public static long _lastRecei vedBytes = -1; 

public static Object ^synchronizedobj = new objectO; 

public static long _time = 0; 

public static long _recordstoreTime = 0; 

public static vector _networkConnection = new vector(3); 

public class Billinglnputstream extends inputstream 
public BillinglnputStreamCinputstream is) 
^ _is = is; 

///////////////////////////////////////////////////////////////////////// 
/////// Public Members (Access Methods) 

public int readC) throws lOException 

int r = _is.readO; 
ifCr != -1) { 
_total Recei vedBytes++ ; 

incrementO ; 
^ return r; 

public int avail ableC) throws lOException 
return _is.availableO; 

} 

public void mark(int readlimit) 
_is.mark(readlimi t) ; 

} 

public boolean markSupportedQ 
^ return ^is.markSupportedQ ; 

public int read (byte [] b) throws lOException 

int i = _is.read(b); 
„total Recei vedBytes += i; 
incrementO ; 
return i ; 

} 

public int readCbyte [] b, int off, int len) throws lOException 

int i = _is.read(b, off, len); 
_total Recei vedBytes += i; 
incrementO; 
^ return i ; 

public long skip(long n) throws lOException 
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^ return „is.skip(n); 

public void reset Q throws lOException 
_is. reset O; 

} 

public void closeQ throws lOException 

// save the total received bytes 
if CtotalReceivedBytes > 0) { 

^ PacketBaseBi 1 1 i ng . i ncrementRecei vedBytes Ctotal Recei vedBytes) ; 

// reset the total received bytes in case loseQ is called again 
_total Recei vedBytes = 0; 
^ _is. closeQ; 

private void increment Q 

if Ctotal Recei vedBytes > PACKET) { 

PacketBaseBi 1 1 i ng . i ncrementRecei vedBytes (ctotal Recei vedBytes) ; 
^ „total Recei vedBytes = 0; 

////////////////////////////////////////////////////////////////////////// 
/////// Private Fields 

private inputstream _is; 

private long _total Recei vedBytes = 0; 

private final static int PACKET = 10; 

} 
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